home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 July: Mac OS SDK / Dev.CD Jul 99 SDK1.toast / Development Kits / Mac OS / OpenGL 1.0 SDK / Documentation / transform_hint.txt < prev   
Encoding:
Text File  |  1999-05-18  |  2.4 KB  |  104 lines  |  [TEXT/ttxt]
  1. * Bob Beretta
  2. * Apple Computer
  3. * beretta@apple.com
  4. * 408-974-1051
  5.  
  6. 000000000011111111112222222222333333333344444444445555555555666666666677777777778888888888999999999900000000001111111111222222222233
  7.  
  8. XXX - Not complete yet!!!
  9.  
  10. Name
  11.     APPLE_transform_hint
  12.  
  13. Name Strings
  14.  
  15.     GL_APPLE_transform_hint
  16.  
  17. Version
  18.  
  19.     $Date: 1999/02/09 08:18:20 $ $Revision: 1.0 $
  20.  
  21. Number
  22.  
  23.     160
  24.  
  25. Dependencies
  26.  
  27.     None
  28.  
  29. Overview
  30.  
  31.     The transform_hint extension provides a new target,
  32.     TRANSFORM_HINT_APPLE, for the Hint procedure.  When the
  33.     transform hint is set to FASTEST the GL may choose to 
  34.     implement certain state dependent algebraic simplifications
  35.     in the geometry transformation that affect the sub-pixel
  36.     precision of the transformed vertex coordinates.  
  37.  
  38.     For example, if two polygons are rendered with identical object
  39.     coordinates, different GL state settings, and the transform
  40.     hint set to FASTEST, there is no gaurantee that the resulting 
  41.     window coordinates of the two polygons will be precisely
  42.     identical.  Therefore, precise tests of the window coordinates, 
  43.     such as a depth test setting of EQUAL, should not be used.
  44.  
  45.     If the transform hint is set to NICEST or DONT_CARE, two polygons
  46.     with identical object coordinates will always be transformed
  47.     to identical window coordinates.
  48.  
  49. New Procedures and Functions
  50.  
  51.     None
  52.  
  53. New Tokens
  54.  
  55.     Accepted by the <target> parameter of Hint and the <pname>
  56.     parameters of GetBooleanv, GetDoublev, GetFloatv and
  57.     GetIntegerv :
  58.  
  59.     TRANSFORM_HINT_APPLE                        0x85B1
  60.  
  61. Additions to Chapter 2 of the 1.1 Specification (OpenGL Operation)
  62.  
  63.     None
  64.  
  65. Additions to Chapter 3 of the 1.1 Specification (Rasterization)
  66.  
  67.     None
  68.  
  69. Additions to Chapter 4 of the 1.1 Specification (Per-Fragment Operations
  70. and the Frame Buffer)
  71.  
  72.     None
  73.  
  74. Additions to Chapter 5 of the 1.1 Specification (Special Functions)
  75.  
  76.     Section 5.6, Hints
  77.     The second sentence should be appended with:
  78.     "and TRANSFORM_HINT, indicating the desired quality of vertex coordinate
  79.      transformations."
  80.  
  81. Additions to Chapter 6 of the 1.1 Specification (State and State Requests)
  82.  
  83.     Not done
  84.  
  85. Additions to the GLX Specification
  86.  
  87. GLX Protocol
  88.  
  89.     None
  90.  
  91. Errors
  92.  
  93.     None
  94.  
  95. New State
  96.  
  97.     Get Value            Get Command Type Value     Attrib
  98.     -------------------- ----------- ---- --------  ------
  99.     TRANSFORM_HINT_APPLE GetIntegerv  Z3  DONT_CARE hint
  100.  
  101. New Implementation Dependent State
  102.  
  103.     None
  104.